Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_PT_GETLEVELNAME

EOS_PT_GETLEVELNAME

This function returns the name of a level given the level number (0-based).

Syntax

Result = EOS_PT_GETLEVELNAME( pointID, level, levelname [, LENGTH=variable] )

Return Value

Returns SUCCEED (0) if successful and FAIL (–1) otherwise.

Arguments

pointID

Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.

level

Point level (0-based long).

levelname

A named variable that will contain the level name (string).

Keywords

LENGTH

Set this keyword to a named variable that will contain the string length of the level name.

Examples

In this example, we return the level name of the 0th level of the second point defined in the EOS_PT_DEFLEVEL section:

status = EOS_PT_GETLEVELNAME(pointID2, 0, levelname)

Version History

 

5.2

Introduced